Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Printing With QuickDraw GX

GXFinishPage

You can use the GXFinishPage function to notify QuickDraw GX that you have finished capturing shapes for the page.

void GXFinishPage (gxJob aJob);

aJob

A reference to the job object being printed.

DESCRIPTION

You should call the GXFinishPage function after you have finished drawing the data for a page using the GXDrawShape function. In the aJob parameter, you specify the job object being printed.

After you call the GXFinishPage function for the final page to be printed, call the GXFinishJob function to notify QuickDraw GX that printing is complete.

SPECIAL CONSIDERATIONS

You should only call the GXFinishPage function if the GXStartPage function doesn't return errors.

RESULT CODES

gxPrUserAbortErr	The user has canceled printing.
gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.

In addition to the following result codes, you may also receive errors that can occur while flattening graphics objects during spooling. Flattening graphics objects is described in the shape objects chapter of Inside Macintosh: GX Objects.

SEE ALSO

Listing 2-6 on page 2-23 shows how to use the GXFinishPage function to tell QuickDraw GX that you have finished capturing shapes.

The GXStartPage function is described in the previous section.

The GXDrawShape function is discussed in the shape objects chapter of Inside Macintosh: GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help